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PREFACE 


The operation and use of the XVM/DOS Utility Program 8TRAN are described in this manual® 

It was assumed in the preparation of this manual that the reader is familiar with the operation 
of the PDP“8 and XVM computer systems and with their assembly languages® 






CHAPTER 1 
INTRODUCTION 


8TRAN Is a relocatable program which assists In the translation of PDP-8 programs to 
XVM programs® 8TRAN accepts source coding In PAL—111, PAL-D, or MACRO “8 
assembly languages and produces source code In MACRO XVM (MACRO) assembly language 0 
Its main functions are: 


Reformatting of statements 
Translation of mnemonics 

Insertion of flags to indicate either that instructions have been 
translated or that translation is Impossible B 


NOTE 

EAE coding and any Input/output instructions other 
than those for the reader/punch and Teletype® must 
be modified® Floating point instructions are trans¬ 
lated to calls to floating point subroutines® 


Symbols used in this manual are defined as follows® 


Symbol 

Meaning 


Carriage RETURN 

H 

Horizontal tab 

SL^-JS 

Space 

[ ] 

Optional command element 

{} 

One of the enclosed 
command elements must 
be chosen® 


® Teletype is a registered trademark of the Teletype Corporation® 




CHAPTER 2 
INSTRUCTION SETS 


2.1 MEMORY REFERENCE INSTRUCTIONS 

Table 2-1 shows the correspondence between the PDP-8 and XVM instruction sets. 


Table 2-1 

Correspondence Between Memory Reference Instructions 


PDP- 

-8 

XVM 

Mnemonic 

Octal 

Mnemonic 

Octal 

AND 

0000 

AND 

500000 

TAD 

1000 

TAD 

340000 

ISZ 

2000 

ISZ 

440000 

JMS 

4000 

JMS 

100000 

JMP 

5000 

JMP 

600000 

DCA 

3000 

DAC 

CLA 

040000 



CAL 

j 

000000 



DZM 

140000 



LAC 

200000 



XOR 

240000 



ADD 

300000 



XCT 

400000 



SAD 

540000 


2.2 INDIRECT REFERENCES AND AUTO-INDEX REGISTERS 

Single level indirect addressing is identical on both machines. 


PDP-8 


XVM 


i 

0400 

* 


020000 








Instruction Sets 


The Auto-lndex Registers (10-17) also operate identically 0 However, the PDP-8 has one set of Auto-Index 
Registers for each 8K memory field, while the XVM has only one set of Auto-Index Registers in Page 0 
of Bank 0 S 


2.3 OPERATE INSTRUCTIONS 

A single group of Operate instructions in XVM corresponds to the two groups in PDP-8, as shown in Table 2-2* 


Table 2-2 


Correspondence Between Operate Instructions 


PDP-8 

XVM 


NOP or OPR 

7000 

NOP or OPR 

740000 


CLA 

7200 

CLA 

750000 


CLL 

7100 

CLL 

744000 


CMA 

7040 

CMA 

740001 


CML 

7020 

CML 

740002 


RAR 

7010 

RAR 

740020 


RAL 

7004 

RAL 

740010 


RTR 

7012 

RTR 

472020 


RTL 

7006 

RTL 

742010 


IAC 

7001 

IAC 

740030 

Group 2 

CLA 

7600 

CLA 

750000 


SMA 

7500 

SMA 

740100 


SZA 

7440 

SZA 

740200 


SNL 

7420 

SNL 

740400 


SPA 

7510 

SPA 

741100 


SNA 

7450 

SNA 

741200 


SZL 

7430 

SZL 

741400 


SK P 

7410 

SKP 

741000 


OSR 

7404 

OAS 

740004 


HLT 

7402 

HLT 

740040 


2.4 LAW INSTRUCTION 

The LAW instruction in XVM has no equivalent in PDP-8 0 The mnemonic LAW N has an octal value of 
760000 + N. 


2 @ 5 PAGING 

The address portion of Memory Reference Instructions consists of 8 bits on the PDP-8 and 12 bits on the 
XVM, permitting direct addressing of 4K on the XVM« 


Using indirect address references, the address size is 12 bits in PDP-8 and up to 17 bits in XVM, so 
that data and Instruction fields are not required in XVM* 
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CHAPTER 3 
ASSEMBLERS 


The symbolic programs acceptable to PAL 11 l/MACRO-8 and to MACRO XVM (MACRO) are similar 
in most respects. The important differences which do exist are discussed in this chapter. 


3.1 FORMAT 

The MACRO Assembler is field-oriented, which means that the interpretation of a statement depends 
on the field in which each element of the statement lies. There are four fields: 


LABEL 

OPERATION 

ADDRESS 

COMMENT 


(Field delimiter) 
(Field delimiter) 
(Field delimiter) 
(Statement delimiter) 


A field delimiter is either a space or a tab. A statement delimiter is either a Carriage RETURN or a semicolon. In 
this document, tabs are indicated with the symbol -»), and carriage returns are indicated with ). 

In MACRO there is no field for an indirect reference because indirect addressing is indicated by an 

asterisk (*) immediately following the mnemonic operator in the operation field. 


Examples: 


TAG, 


PDP-8 

XVM 

TAD A 

TAG H TAD 

ISZ I B 

-^ISZ* 

JMP C 

H JMP 


—&| A 
H B 

He 


Tabs are normally preferred to spaces as field delimiters. MACRO does not require commas to terminate labels 
Labels appearing on successive lines without any code are given consecutive addresses by MACRO, not the 


same address; an important difference from the PDP-8 assembler. 
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Assemblers 


3.2 SYMBOLS 

Symbols in MACRO may use period (.) and percent sign (%) in addition to letters and numbers. The initial 
character must be a letter, period (.), or percent sign (%). 

3.3 EXPRESSION OPERATORS 

MACRO has a more extensive set of operators than does PAL-ill/MACRO-8. Addition (+), 

Subtraction (-), AND (&), and Inclusive OR (!) are supplemented by Exclusive OR (\), 

Multiplication (*), and Division (/). 

3.4 NUMBERS 

18 17 

Octal and decimal numbers in the range ±2 -1 for unsigned integers and ±2 -1 for signed integers are avail 

able in MACRO. Double precision and floating-point constants (DUBL and FLTG pseudo-ops of MACRO-8) 
are not permitted in MACRO. 


3.5 LOCATION COUNTER 

The Location Counter may be referenced by period (.) in both systems. It is set as follows: 


PDP-8 


* 


n 


.LOG 


XVM 


n 


PAGE n 


Ignored 

Paging is redundant in 


XVM 


The Location Counter is advanced as follows: 


PDP-8 

XVM 

* . + n 

.BLOCK 


The .BLOCK pseudo-op makes the operation more explicit in XVM. 


3.6 TEXT HANDLING 

Pseudo-ops to perform packing of 6-bit trimmed ASCII characters are available in both systems. 


PDP-8 

XVM 

TEXT 

. SIX BT 
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Assemblers 


The 18-bit word in the XVM permits 3 characters per word, as compared with 2 characters per word in PDP-8 c 

An additional pseudo-op which performs the packing of five 7-bit ASCII characters in two words ( e ASCII) is 
available in the XVM® 


3.7 TERMINATING PSEUDO-OPS 

The correspondence between the two systems is: 


PDP-8 

XVM 

PAUSE 

.EOT 

$ 

.END 


3.8 LITERALS 

Page zero literals have no meaning in XVM® The correspondence is: 


PDP-8 

XVM 

[ 

( 

( 

( 

] 

) 

) 

) 


It should be noted that neither nested literals, e.g. , TAD (TAD (20)), nor 8-bit ASCII characters, e.g (/ TAD 
("A), are allowed in MACRO® 

3.9 SYMBOL TABLE 

The Symbol Table of MACRO cannot be deleted, hence EXPUNGE is not a valid pseudo-op® 

Since the permanent Symbol Table of MACRO is searched for octal matching and not symbol matching the 
pseudo-ops FIXMRS and FIXTAB are redundant® A memory reference instruction is defined by a parameter 
assignment, e Q g e , IDX=ISZ, or IDX=440000 e 

3.10 USER MACROS 

User Macros can be more elaborate in MACRO; the correspondence between the sets is: 


PDP-8 

XVM 

DEFINE 

.DEFIN 

< 

Not used 

> 

. ENDM 
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CHAPTER 4 
INPUT/OUTPUT 


The most important difference between the PDP-8 and the XVM in I/O lies in the fact than an extra 3 bits 
(12-14) are available in the XVM instruction word® 

Bits 12 and 13 are used for subdevice selection, and Bit 14, when set, clears the AC at event time 1; i.e., prior 
to transfers to/from the AC. 

4.1 FLAGS 

The XVM has two instructions, not available on PDP-8, which read and clear flags® 

IORS Input/Output Read Status 

CAF Clear All Flags 


4,2 INTERRUPT 

The interrupt structure is identical on both machines. When the interrupt function is enabled (ION), the setting 
of a flag will cause an interrupt; i.e., an effective JMS to location 0 of field 0. 

The XVM has an 18-bit word so that the full 15-bit address of the interrupt location is stored, eliminating 
the need for the 6-bit Interrupt Buffer in the PDP-8 e 

The remaining 3 bits of the XVM word are used to store the state of the Link, Bank/Page Mode, and Memory 
Protect® 


XVM 


L 

BPM 

MP 

ADDRESS (15-Bits) 

0 

1 

2 

3-17 
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input/Output 


4.3 TELETYPE 

There are two differences in the IOT instructions between PDP-8 and XVM® 


KCC does not exist on the XVM S The Keyboard Flag is cleared by issuing a KRB, which also reads the buffer„ 
All other Teletype lOTs are identical* 


PDP-8 


XVM 


KCC 

KRS 


None (use KRB) 
None (use KRB) 
KRS (Keyboard 


Reader Select) 


4.4 READER/PUNCH 

All reader/punch functions available on the PDF-8 are also available on the XVM® The PDP-8 operates in 
Alphanumeric mode only, while the XVM operates in Binary mode as well as Alphanumeric mode* (Binary 
permits the reading of an 18~bit word from 3 lines of tape and the punching of a single line in the format of 
the binary read®) 


PDP-8 

XVM 

RSF 

RSF 

RRB 

RRB 

RFC 

RSA 

_ 

RSB 

PLS 

PSA 

— 

PSB 

PCF 

PCF 

PSF 

PSF 


4.5 DECTAPE 

The DECtape controllers, TC01 on PDP-8 and TC02 on XVM, work in an identical manner® 


The standard format of data on the tape differs significantly (see Table 4-1). There is, however, no incompati¬ 
bility of control word format; therefore, a standard block of 129 words written by the PDP-8 can be read as a 
block of 86 words by the XVM® 
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Input/Output 


Table 4-1 

Tape Standard Data Format 



PDP-8 

XVM 

Words 
per Block 

129io 

(12 bits) 

256, o 
(18 bits) 

Blocks 

0-2701 8 

o-noi 8 

Address of 

Word Count 

7754 

30 

Address of 

Current Address 

-i 

7755 

31 


The instructions to the two controllers differ in only one respect. The single IOT DTSF (skip if error flag or DEC- 
tape control flag=l) in the TC01 is replaced by the two IOTs, DTDF (skip if DECtape control flag=l) and DTEF 
(skip if DECtape error flag=l), on the TC02. 

The two Status Registers, A and B, are 12 bits on both machines (AQ0-AC11 on the XVM). 

4.6 IOTs IN PERMANENT SYMBOL TABLE 

MACRO assumes that input/output will be handled by I/O System Macros using device handlers. Device¬ 
dependent IOTs are therefore not included in the Symbol Table. The P (parameter) oDtion in MACRO provides 
the facility for adding to the Symbol Table prior to an assembly; IOTs may always be assigned in this manner 
If requ I red @ 










CHAPTER 5 

EXTENDED ARITHMETIC ELEMENT 


Any EAE coding for the PDP-8 should be rewritten for the XVM, since: 

a. The word length on the two machines is different. 

b. The XVM EAE is considerably more powerful than its PDP-8 counterpart* 
Table 5-1 indicates the correspondence between the two instruction sets. 


Table 5-1 

Correspondence Between Instruction Sets 


PDP-8 

XVM 

DVI 

DVI 

NMI 

NORM 

SHL -t 

N J 

LLS+N+1 

ASR 1 

N J 

LRSS+N+1 

LSR \ 

N •» 

LRS+N+1 

MQL 

LMQ 

MUY 

MUL 

MQA 

OMQ 

CAM 

CLQ 

SCA 

OSC 


5.1 MULTIPLICATION AND DIVISION 

Signed operations (MULS and DIVS) are available on XVM S The full number of shifts is always performed in 
multiplication and division on PDP™8 0 The number of shifts in XVM is programmable (contained in bits 12-17 
of the instruction word) to reduce execution time where numbers are less than 18 bits in magnitude* 
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Extended Arithmetic Element 


In division, the high order part only or the lower order part only of the dividend may be used i 
alternatives to the usual double word operation. 

(IDIV, IDIVS, FRDIV, FRDIVS) 


5.2 SHIFTING 

Three additional shifting operations are available on XVM @ They are: 

a. Signed left shift (LLSS) 

b. Accumulator left shift (ALS) 

c. Signed accumulator left shift (ALSS). 


n the operation as 
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CHAPTER 6 

FLOATING-POINT ARITHMETIC 


Both the format and the treatment of floating-point numbers are different on the two machines. 


6.1 FORMAT 


PDP-8 


Three-word 


Two-word 


XVM 


SIGN 


Exponent 

2's Comp 


0 1 


n 

SIGN 


High-Order 

Mantissa 


0 1 

n 


Low-Order 

Mantissa 


0 


n 


Mantissae are in 2‘s complement 


SIGN 


Low-Order 

Exponent 

Mantissa 

2's Comp 

0 

89 17 


High-Order 

Mantissa 

0 1 

17 


Three-word 


SIGN 


Exponent 

2's Comp 

0 

17 


High-Order ( 


Mantissa 

0 1 

17 


Low Order 


Mantissa 

0 

17 


Negative mantissae are indicated 
by setting bit 0 of the high-order 
word (i.e, Sign-Magnitude nota¬ 
tion) 
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Floating-Point- Arithmetic 


6.2 ARITHMETIC PACKAGE 

The PDP-8 performs floating-point arithmetic by use of an interpreter. 8TRAN translates the 
PDP-8 floating-point instructions into subroutine calls with the address of the argument in the 
location following the JMS® The user may either provide the necessary floating-point 
arithmetic subroutines, or translate the subroutine calls to hardware FPP instructions if FPP 
hardware is available® Indirect addresses are indicated by setting bit 0 of the word following 
the JMS (i®e®, XCT). 

The correspondence between the two systems is shown in Table 6-1 » 


Table 6-1 

Correspondence Between Arithmetic Packages 


PDP-8 

XVM 

JMS 17 (Enter Interpreter) 

None (not interpretive) 

FADD A 

JMS -*)FAD 

A 

FSUB 1 B 

JMS Hfsub 

XCT HB 

FMPY 

JMS HFMPY 

FDIV 

JMS -ejFDVD 

FGET 

JMS Hflac 

FPUT 

jms Hfdac 

FNOR 

JMS -H%fnor 

FEXT 

None (not interpreted) 


6.3 INPUT/OUTPUT 

On the PDP-8, numbers are input to and output from the floating accumulator® 

8TRAN translates the PDP-8 I/O calls to subroutine calls followed by an argument. On input, 
bit 0 of the argument indicates the input device (other bits are ignored). On output, bit 0 
indicates the output device, the other bits indicate the number of digits in the mantissa 
outputJ 


^COMPACT-15 used bit 0 to Indicate the input or the output device® The important thing to 
note is that PDP-8 I/O requests are translated into subroutine calls® 




Floating-Point Arithmetic 


PDP-8 

XVM 

MS 1 5 

fjMS ■ 


l o 

JMS 1 6 

fjMS • 


l 6 


Floating-point constants must be changed, and where FLTG is used in MACRO m 8 the appropriate 
octal numbers must be Inserted,, 

Examples: 


Decimal 

PDP-8 

XVM 

0.1 

7775 

460775 


3146 

314631 


3146 


-7.0 

0003 

000003 


4400 

740000 


0000 


ir 

0002 

550002 


3110 

311037 


3755 


5.0 

FLTG 5.0 

000003 



240000 




CHAPTER 7 

TRANSLATOR FUNCTIONS 


The Translator program accepts a symbolic source tape (or file) written in either PAL III, PAL D, or MACRO-8, 
and translates it to MACRO assembly language, within the limits described below. 


7.1 FORMATS 

Each statement is reformatted in MACRO format. The Translator inserts a tab after a label field and after 
the operation field, so that the MACRO listing appears in columns as shown in the examples below. 


PDP-8 


TAG,CLA CMA 
TAD I Z AUTO 


TAG 


XVM 


CLAICMA 
TAD* AUTO 


[The optional page zero indicator (Z) is ignored.] 


7.2 TRANSLATION 

The following translations are performed. (Mnemonics processed by the Translator, and their translation where 
appropriate, are listed in Appendix A.) 


7.2.1 Memory Reference Instructions 


PDP-8 

XVM 

DCA LOC 

Jdac 


1 CLA 


HLOC 


Where DCA is followed by TAD, the CLA in the above translation may sometimes be eliminated. The Translator 
treats the situation in one of three ways: 
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Translator Functions 


PDP-8 

XVM 

DCA LOG 

DAC 

LOC 

TAD LOG 



DCA LOCI 

DAC 

LOCI 

TAD LOC2 

LAC 

LOC2 

DCA LOC 

DAC 

LOC 

TAG,TAD LOC 

CLA 



TAG TAD 

LOC 


In the last example above,, the CLA is not eliminated because the TAD is labeled. 


Where successive DCAs are translated, DZM replaces each DCA after the first, terminating the last DZM with a 
CLA. If a DCA is tagged, however, DZM is not generated. 


PDP-8 

XVM 


DCA LOCI 

DAC 

LOCI 

DCA LOC2 

DZM 

LOC2 

DCA LOC3 

DZM 

LOC3 

TAG, DCA LOC4 

CLA 


JMP LOC5 

TAG DAC 

CLA 

LOC4 


JMP 

LOC5 


other MRIs are transferred without change. 


,2 Input/Output Instructions 


PDP-8 

XVM 

RFC 

RSA 

PIS 

PSA 


All other Teletype and reader/punch instructions are transferred without change. IOT instructions for other de¬ 
vices are declared undefined symbols (see Section 7 0 3J § 4) 9 
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Translator Functions 


7.2.3 Operate Instructions 


PDP-8 

XVM 

IAC 

IAC 

CLA IAC 

CLA! IAC 

CIA 

CMAUAC 

CLL RTL 

CLL 


RTL 

OSR 

OAS 

CLA OSR 

LAS 


Double-rotate instructions are separated from other instructions because of conflicting event times 0 
Single-rotate instructions are also separated when they conflict. 

7.2.4 Pseudo-Operations 

7.2.4.1 Miscellaneous 


PDP-8 

XVM 

DECIMAL 

.DEC 

OCTAL 

.OCT 

PAUSE 

.EOT 

$ 

.END 


The PDP-8 pseudo-ops PAGE and * for setting the location counter are not translated. 


7.2.4.2 Text Handling 


PDP-8 

XVM 

TEXT 

. SIX BT 


Both e SIXBT in MACRO and TEXT in PDP-8 assemblers treat text strings as trimmed ASCII. MACRO stores 
three characters per 18-bit word* 


7.2.4.3 Macro Defining - The left angle bracket (<) used in MACRO-8 is ignored* However, instructions 
within a macro are translated. 
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PDP-8 

XVM 

DEFINE 

.DEFIN 

< 

ignored 

> 

„ENDM 


7.2.5 Literals 


PDP-8 

XVM 

[ 

( 

] 

) 

("N 

(nnn 


Page 0 literals are translated as ordinary literals. Instructions within literals are translated. ASCII characters 
are translated into their 7-bit octal equivalent. 


7.2.6 Floating Point 


PDP-8 

XVM 

FEXT 

Ignored 

FADD 

JMS H FAD 

FSUB 

JMS H FSUB 

FMPY 

JMS -4 FMPY 

FDIV 

JMS Hfdvd 

FGET 

jms Hflac 

FPUT 

jms Hfdac 

FNOR 

JMS H%fnor 

1 

XCT 

JMS I 5 

JMS -4 FLIP 


0 

JMS I 6 

jms Hflop 


6 

JMS I 7 

Ignored 


The calls to the Input/Output routines (JMS I 5 and JMS I 6) and the entry to the interpreter (JMS I 7) are 
frequently given other names by parameter assignment. Where these instructions occur in a parameter assignment, 
the following translations occur. 
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PDP-8 


XVM 


JMS I 5 
JMS I 6 
JMS I 7 


JMS -(FLIP 
JMS Hflop 
NOP 


The arguments of JMS FLIP and JMS FLOP are dropped and any entry to the interpreter is effectively ignored. 
However, the input and output calls must be followed by arguments, so insertion would have to be made at ap¬ 
propriate points in the program. 


Floating-point variable storage can be reduced by one location for each variable, but no program error will oc¬ 
cur if this is not done. 


7.3 FLAGS 

Flags are inserted to signal translations (or the absence of a translation) which may result in incorrect operation 
when assembling on the XVM. A flag occurs as a comment after the relevant instruction, starting on a new 
line, and is always preceded by 


followed by a brief message, as defined below and summarized in Appendix B. There are two types of flags, op- 
tional and mandatory. 

7.3*1 Optional Flags 

Optional flags may be suppressed by the user because the appearance of these flags does not necessarily mean 
that changes have to be made to the program. (The method of suppressing optional flags is explained in Chapter 
8.) The Translator may insert optional flags for the conditions described below. 

7.3.1.1 Additional Code - When the Translator generates extra lines of code, a flag may be raised. The two 
situations are: 

DCA A DC A instruction was translated into DAC followed by CLA. 

SMI (Segmented Micro-Instruction) - A segmented microinstruction was encountered 

which could be translated only by-splitting it info two instructions. 


7.3.1.2 Relative Addresses - Since extra lines of code are generated, any relative address which occurs in the 
program may be in error. 
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REL An address followed by ±n (where n is a number) was encountered. 

7-3.1.3 Rotate Instructions - Since the word length of the two machines is different, the use of rotate instruc¬ 
tions may result in incorrect operation 

ROT A single or double rotate instruction was encountered. 

7 o 3J A Undefined Symbols - Since the Translator contains tables of pseudo “-operations. Memory Reference, 
Operate, and Teletype and reader/punch I/O instructions only, any other symbol encountered in the opera¬ 
tion field is undefined 9 Provision is therefore included to read a User Symbol Table prior to translation, so 
that a symbol is not declared undefined until a search of all user symbols has been made® 


US An undefined symbol was found in the operation field. 


NOTE 

1) If a User Symbol Table is to be retained for a number 
of tapes, each tape except the last must be terminated 
by a PAUSE pseudo-op. 

2) If a User Symbol Table is not read prior to translation, 
it will be built during translation; hence only forward 
references in the operation field will be flagged. 


7.3.2 Mandatory Flags 

The flags in this group are always printed for a reason (see sections 7®3®2J through 7 c 3 e 2 e 6) e 


7.3.2.1 Location Counter Settings - The setting of the location counter by PAGE and * is ignored, and the 
code is simply printed as a comment. 

LOC A location counter setting was ignored. 


NOTE 

Each translation is preceded by .ABS and .LOC 100. 


7. 3.2.2 Illegal Characters - When an illegal character is encountered, its octal value in 7-bit ASCII is output. 
The character is ignored. 
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1C nnn Illegal character. 

7.3.2.3 Literals - Instructions within literals are translated only if the translation comprises a single line of 
code. Nested literals are illegal in MACRO® 

LIT A literal was nested, or. If translated, would have produced extra code. 

7®3®2 9 4 Multiple Precision Constants - In XVM, the representation of double precision 
integers (DUBL) and floating-point constants (FLTG) is different from their representation 
in PDP-8 Q They are not translated® 

MFC A DUBL or FLTG pseudo-operation was encountered and ignored. 

7.3.2.5 Skip Instructions - If the instruction following a Skip instruction is segmented, the Skip will cause an 
error at execution: 

SKP A segmented microinstruction followed a Skip instruction® 

7®3®2 e 6 Symbol Table Overflow - The symbol table capacity is all of the unused core between ®SCOM+2 
and oSCOM+3, If the symbol table is filled, no further symbols will be stored and the following message 
is given: 


SE Symbol Table Exceeded. 


7-7 






CHAPTER 8 
OPERATION 


Appendix C provides a typical example of 8TRAN operation in the XVM/DOS environment® 

8,1 ,DAT SLOT ASSIGNMENTS 

The following e DAT slots are used: 

-I 5 Input 
“14 Output 
“3 Messages 
“2 Command String 


NOTE 

8TRAN uses the system Macro 0 F$TAT e Any 
file^oriented device handler used must recognize 
e FSTAT, otherwise an IOPS6 error will occur. 


8,2 CALLING PROCEDURE 

After the Monitor's $, call 8TRAN by typing 8TRAN followed by a Carriage RETURN. 


When loaded. 


8TRAN XVM Vnxnnn (where Vnxnnn is the current version) 


is printed on the teleprinter and the program waits for your command string. 
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8*3 COMMAND STRING 


The command string has the format : optionss^jfi lenam^jexfiu^terminator 


Options 

S = Read a symbol table 
prior to translation 

F = Suppress output of 
optional flags* When 
this option is selected, 
8TRAN types: 

FLAGS” 


fi I en a mew,ext 


terminator 


Name of symbol table 
or file to be translated* 
Default for extension 
(ext) is SRC® 


ALT MODE - Return to Monitor 
after current operation 

d- Restart 8TRAN after 
current operation 


Any or all of the Optional Flags (see Table 8-1) are printed in any order separated by a 
space or comma and terminated by a Carriage RETURN* 


#» 




Table 8-1 

Optional and Mandatory Flags 


OPTIONAL 

Flag 

Meaning 

DCA 

A DCA instruction was translated. 

1C nnn 

An illegal character was encountered and ignored (nnn is^ the character's octal 
value in 7-bit ASCII)® 

REL 

A relative address was encountered® 

ROT 

A rotate microinstruction was encountered® 

SMI 

A segmented microinstruction was encountered® 

MANDATORY 

Flag 

Meaning 

LIT 

A literal either was nested or, if translated, would have produced extra code® 

LOC 

A location counter setting was ignored® 

MPC 

A DUBL or FLTG pseudo-op was found and ignored* 

SE 

The symbol table was exceeded® 

SKP 

An SMI followed a SKP Instruction® 
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8.4 OPERATING PROCEDURE 

The program to be translated and its symbol table, if required, must be ready on the appropriate 
device before the command string is typed. If the input is on a directoried device, both the 
symbol table and the program to be translated must be on the same disk UIC, DECtape, or 
magtape* 

If the S option is selected, if must be followed by the name of the symbol table file* This file 
is the symbol fable output from either PAL III or MACRO-8 0 

Example: 

>S«- SYMTAB^ 

After the symbol table has been read, 8TRAN prints: 

SYMBOL TABLE READ 
> 

and waits for the name of the file to be translated s 
Example: 

><-prgnamJ 

If a PAUSE pseudo-op is encountered, the symbol fable is preserved for the translation of 
other programs® 8TRAN prints: 

PAUSE 

> 


and waifs for another command string® 


8*5 ERROR CONDITIONS 


Table 8-2 provides the error conditions which may occur and their meanings* 
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Table 8-2 

Error Conditions and Their Meanings 


Error Condition 

Meaning 

?? 

Bad command string - retype 

INPUT FILE NOT ON DEVICE 

8TRAN cannot find the file named in the command 
string - retype 

OUTPUT FILE ALREADY ON 

DEVICE TYPE +PTO 

RESTART OR CR TO OVERWRITE 

The program named in the command string (with 

SRC extension) is already on the output device 

IOPS 4 

I/O device not ready - type CTRL R when ready, 

IOPS 0-77 

See Appendix C of the XVM/DOS Keyboard 

Command Guide 


Examples: 


(User responses are underlined & ) 


o 0 To translate a program and symbol table on paper tape: 

8TRAN XVM Vnxnnn 
SYMBOL TABLE READ 

bo To translate a program with no symbol table and the ROT and SMI options suppressed 
using directoried I/O: 

8TRAN XVM Vnxnnn 
>F«-PRGNAM ?klJ 
FLAGS-ROT,SMI J 
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APPENDIX A 
SYMBOL TRANSLATIONS 


PDP-8 


XVM 


PDP-8 


Memory Reference 


AND 



AND 

SZL 

TAD 



TAD 

SZA 

ISZ 



ISZ 

SNA 

DCA 



(DAC 

SMA 




(CLA 

SPA 

JMS 



JMS 


JMP 



JMP 


I 



* 

CIA 

Z 



Ignored 

STL 


Operate 


GLK 





STA 

NOP 



NOP 

LAS 

OPR 



OPR 


IAC 



IAC 


RAL 



RAL 

IOF 

RTL 



RTL 

ION 

RAR 



RAR 

IOT 

RTR 



RTR 

KSF 

CML 



CML 

KRB 

CMA 



CMA 

TCF 

CLL 



CLL 

TSF 

CLA 



CLA 

TLS 

HLT 



HLT 

RFC 

OSR 



OAS 

RSF 

SKP 



SKP 

RRB 

SNL 



SNL 

PLS 


Operate (Cont) 



Input/Output 


A-l 


XVM 

SZL 

SZA 

SNA 

SMA 

SPA 

CMAIIAC 

STL 

GLK 

CLC 

LAS 

IOF 

ION 

IOT 

KSF 

KRB 

TCF 

TSF 

TLS 

RSA 

RSF 

RRB 

PSA 



Symbol Translations 


PDP-8 


XVM 


PDP-8 


XVM 


Input/Output (Cont) 


PCF 

PCF 

PSF 

PSF 


FEXT 

FADD 

FSUB 


Floating Point 

Ignored 
JMS FAD 
JMS FSUB 


FMPY 

FDIV 

FGET 

FPUT 

FNOR 

I 

JMS I 5 
JMS I 6 
JMS I 7 


JMS FMPY 
JMS FDVD 
JMS FLAC 
JMS FDAC 
JMS%FNOR 
XCT 

JMS FLIP 
0 

JMS FLOP 
6 

Ignored 



PAUSE 

$ 

DEFINE 

< 

> 

EXPUNGE 

FIXMRI 

FIXTAB 


.EOT 
.END 
. DEFIN 
Ignored 

. ENDM 
Ignored 
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APPENDIX C 

8TRAN DEMONSTRATION 


This appendix is a demonstration of 8TRAN operation in the XVM/DOS environment The listing in the 
left column is the MACRO“8 source program to be translated. (For the convenience of the reader, 
additional spaces have been Inserted in the body of the listing to align the code*) The column on the 
right of the page is an 8TRAN output listing showing the results of translation® 

NOTE 

Summaries of symbol translations and diagnostic flags 
are provided in Appendices A and B respectively. 


MACRO"“8 Program 


Translation 


/DIGIT OCTAL SQUARE CONVERSATIONAL 
/PROGRAM 
*200 

start, c l a 

t l s 

JMS 
JMS 
TAD 
RAL 
RTL 
DC A 
JMS 
TAD 

tad 

DC A 


. ABS 

.LOC 100 

/DIGIT OCTAL SQUARE CONVERSATIONAL 
/PROGRAM 


/ 

-LOC 

*200 


START 

CLA!CLL 




TLS 




JMS 

CRLF 



JMS 

LISN 



tad 

CLL!RAL 

M260 

/ * 

-ROT 

RTL 


/ ** 

-ROT 

DAC 

NUMBER 

/ * a- 

-DCA 

CLA 




JMS 

LISN 



tad 

M260 



tad 

number 



DAC 

NUMBER 

/ a- 

-DC A 

CL A 



CRLF 

LISN 

M260 > 

CLL 

NUMBER 
LISN 
M 2 6 0 
NUMBER 

number 
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8TRAN Demonstration 


mult , 


TYPSQU » 


TYPANS. 


UNPACK, 


TYPOCT , 


MACRO-8 Program 


Translation 





MULT 

TAD 

NUMBER 





CM A! I AC 






DAC 

TALLY 

tad 

number 


/** ~DCA 



CIA 




LAC 

NUMBER 

DC A 

TALLY 



ISZ 

TALLY 

tad 

number 


) 

JMP 

.“2 

ISZ 

tally 


/** “REL 



JMP 

. -2 



DAC 

NUMSQR 

DC A 

NUMSQR 

J 

/** “DCA 







CLA 





TYPSQU 

TAD 

MESAG1 





DAC 

POINTR 

tad 

MESAG1 


/** -DCA 



DC A 

POINTR 



LAC 

M 1 0 

TAD 

MiG 

\ 

) 

DAC 

FNDCHK 

DC A 

ENDCHK 

| 

/** -DCA 



JMS 

mesage 

J 


CLA 






JMS 

MESAGE 




TYPANS 

TAD 

M 4 





DAC 

D I GCTR 

TAD 

M 4 


i /* * -DCA 



DC A 

DIGCTR 

1 


D2M 

STORE 

DC A 

STORE 


> 

LAC 

NUMSQR 

TAD 

NUMSQR 



CLL!RAL 


CLL RAL 



/*» -ROT 






unpack 

TAD 

STORE 





RAL 


tad 

STORE 


/** “ROT 



RAL 




RTL 


RTL 



/** -ROT 



OCA 

STORE 



DAC 

STORE 

tad 

STORE 


> /*■* -DCA 



AND 

K 7 


f 

AND 

K 7 

TAD 

K 2 60 



T aD 

K260 

JMS 

TYPE 



JMS 

type 

I SI 

DIGCTR 



ISZ 

D I GCTR 

JMP 

UNPACK 







j 


JMP 

UNPACK 




TYPOCT 

T AD 

MESAG2 



“■> 


DAC 

POINTR 

TAD 

MESAG2 


/#* -DCA 



dca 

POINTR 



LAC 

M7 

tad 

M 7 


L 

DAC 

FNDCHK 

DCA 

ENDCHK 


f /**-0CA 



JMS 

MESAGE 



CLA 


JMS 

CRLF 



JMS 

MESAGE 

JMP 

ST ART *2 

J 


JMS 

CRLF 





JMP 

startup 


/** -REl. 
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8TRAN Demonstration 



MACRO“8 Progra 

m 


** 

Translation 






TYPE 

0 


TYPE 9 

0 



' 

TSF 



TSF 




JMP 

.“1 


JMP 

. -1 


/#* -REL 




TLS 



/ 

TLS 



CL A 




CLA 



JMS I 

TYPE 



JMS * 

TYPE 

CRLF k 

0 



CRLF 

0 



TAD 

K215 



TAD 

K215 


JMS 

TYPE 



JMS 

TYPE 


TAD 

K212 


> 

TAD 

K212 


JMS 

TYPE 


| 

JMS 

TYPE 


JMP I 

CRLF 



JMP* 

CRLF 

LISN, 

0 



LISN 

0 



KSF 


> 

i 

KSF 







JMP 

. “1 


JMP 

KRR 

. -I 


1 /** -REL 







f 

KRB 



TLS 




TLS 



JMP I 

LISN 



JMP* 

LISN 





MESAGE 

0 


MESAGE, 

0 




TAD* 

POINTR 


TAD I 

POINTR 



JMS 

TYPE 


JMS 

TYPE 



ISZ 

POINTR 


ISZ 

PO INTR 


> 

ISZ 

FNDCHK 


ISZ 

FNDCHK 



JMP 

. -4 


JMP 

. -4 


/** -REL 




JMP I 

MESAGE 



JMP* 

MESAGE 

number , 

0 



NUMBER 

0 


M260 f 

-260 



M26 0 

“260 


TALLY, 

0 



tally 

0 


NUMSQR, 

0 



NUMSQR 

0 


mesagi. 

START! 



mesagi 

START1 


POINTR, 

0 



/** “US 



M10, 

“10 



POINTR 

0 


ENDCHK, 

0 



M10 

“10 


STORE , 

0 



V ENDCHK 

0 


M 4 » 

- 4 



' STORE 

0 


OIGCTR, 

0 



M 4 

-4 


K 7 0 

7 



OIGCTR 

0 


M7, 

“7 



K7 

7 


K260 p 

260 



M7 

-7 


K212, 

212 



K 260 

260 


K215, 

215 



K212 

212 


MESAG2, 

ST ART 2 


J 

K215 

215 






MESAG2 

START2 






/** “US 
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MACRO-8 Program 



Translation 


STARTl, 

323 

/S 

STARTl 

323 

/S 


321 

/a 


321 

/Q 


325 

/u 


325 

/U 


301 

/A 


301 

/A 


322 

/R 


322 

/R 


305 

/E 


305 

/E 


304 

/D 


304 

/D 


275 

/ = 

> 

275 

/ = 

START2, 

240 

/SPACE 

start? 

240 

/SPACE 


317 

/O 


317 

/O 


303 

/c 


303 

/C 


324 

/T 


324 

/T 


301 

/A 


301 

/A 


314 

/L 


314 

/L 


256 

/PERIOH 


256 

/PERIOD 

$ 


J 


. END 
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Addition (+) operator, 3-2 
Additional code, generation of, 7-5 
Addressing, 
direct, 2-2 
indirect, 2-2 
Alphanumeric mode, 4-2 
AND (&) operator, 3-2 
Arithmetic package, 6-2 
ASCII character, 
packing, 3-2, 3-3 
translation, 7-4 
Assemblers, 3-1 
Assembly language, I-1 
Asterisk (*) usage in MACRO, 3-1 
Auto-Index Registers, 2-2 

Bank/Page mode, 4-1 
Binary mode, 4-2 
9 BLOCK pseudo-op, 3-2 

Calling procedure, 8-1 
Carriage RETURN, 1-1 
Character packing, 3-2, 3-3 
Characters, illegal, 7-6 
Choice of elements in command string, 1-1 
Code, generation of additional, 7-5 
Command element, optional, 1-1 
Command string, 8-2 
symbols, 1 -1 
COMPACT-15, 6-2 


*DAT slots, 8-1 
DCA instruction, 7-5 
Decimal numbers, 3-2 
DEC tape controllers, 4-2 
Delimiters, 3-1 
Demonstration program, C-l 
Device, directoried, 8-3 
Device handlers, 4-3 
Direct addressing, 2-2 
Directoried device, 8-3 
Division and multiplication, 5-1 
Division (/) operator, 3-2 
Double precision constants, 3-2 
Double precision integers, 7-7 


EAE coding, 1-1, 5-1 
8-bit ASCII characters, 3-3 
Error Conditions, 8-3, 8-4 
Exclusive OR (\) ooerator, 3-2 
Exoression operators, 3-2 
EXPUNGE oseudo^op,3-3 
Extended arithmetic element, 1-1, 5-1 


Field del imiter, 3-1 
Fields, 3-1 

FIXMRI pseudo-op, 3-3 
FIXTAB pseudo-op, 3-3 
Flags, 1-1, 4-1, 7-5 
optional and mandatory, 8-2 
summary, B-l 
Floating-point, 
arithmetic, 6-1, 6-2 
constants, 3-2, 6-3, 7-7 
instructions, 1 -1 
pseudo-ops, 7-4 
variable storage, 7-5 


Horizontal tab, 1 -1 


Illegal characters, 7-6 
Inclusive OR (!) operator, 3-2 
Indirect addressing, 2-1, 2-2, 6-2 
Input/output, 4-1 
In floating point, 6-2 
instructions, 7-2 
system macros, 4-3 
Instructions, 
input/output, 7-2 
memory reference, 7-1 
operate, 7-3 
reader/punch, 7-2 
rotate, 7-6 
Teletype, 7-2 
Instruction sets, 2-1 
Integers, signed and unsigned, 3-2 
Interrupt structure, 4-1 

Keyboard Flag, 4-2 


Index-1 




Labels, 3-1 
LAW instruction, 2-2 
Left angle bracket (<), 7-3 
Letters in MACRO symbols, 3-2 
Link status, 4-1 
Literals, 7-7 
page zero, 3-3 
pseudo-ops, 7-4 
Location Counter, 3-2 
settings, 7-6 


Macro defining pseudo-ops, 7-3 

MACRO-8, 1-1 

MACRO XVM, 1 -1 

Mandatory flags, 7-6, 8-2 

Memory protect, 4-1 

Memory reference instructions, 2-1, 7-1 

Mnemonics, translation of, 1-1 

Multiple precision constants, 7-7 

Multiplication and division, 5-1 

Multiplication (*) operator, 3-2 


Nested literals, 3-3, 7-7 
Numbers in MACRO symbols, 3-2 


Octal numbers, 3-2 
Operate instructions, 2-2, 7-3 
Operating procedure, 8-3 
Operation of 8TRAN, 8-1 
Operators, expression, 3-2 
Optional command element, 1-1 
Optional flags, 7-5, 8-2 
Overflow of Symbol Table, 7-7 


Page zero literals, 3-3, 7-4 

Paging, 2-2 

PAL-D, 1-1 

PAL-Ill, 1-1 

PAUSE pseudo-op, 8-3 

Percent sign (%) symbol, 3-2 

Period (.) symbol, 3-2 

Permanent Symbol Table of MACRO, 3-3 

Programs, symbolic, 3-1 

Pseudo-operations, 3-2, 7-3 


Reader/punch, 
functions, 4-2 
input/output, 1-1 
instructions, 7-2 
Relative addresses, 7-5 
Rotate instructions, 7-6 


7-bit ASCII characters, 3-3 

Shifting operations, 5-2 

Signed integers, 3-2 

6-bit trimmed ASCII characters, 3-2 

Skip instructions, 7-7 «■ 

SMI (segmented microinstruction), 7-5 
Source code, 1 -1 

Spaces used as field delimiters, 3-1 # 

Space (l-j) symbol, 1-1 

Statement delimiter, 3-1 

Statement reformatting, 1-1 

Status registers, 4-3 

Storage, floating-point variable, 7-5 

Subtraction (-) operator, 3-2 “ 

Suppressing optional flags, 7-5 
Symbolic programs, 3-1 
Symbols in MACRO, 3-2 
Symbols, undefined, 7-6 
Symbol table, 3-3, 4-3 
file, 8-3 
overflow, 7-7 

Symbol translations summary, A-l 


Tab, horizontal, 1-1, 3-1 
Tape standard data format, 4-3 
Teletype, 
input/output, 1-1 
instructions, 4-2, 7-2 
Terminating pseudo-ops, 3-3 
Text handling pseudo-ops, 3-2, 7-3 
Translator between PDP-8 and XVM symbols, A-l 
Translator functions, 7-1 


Undefined symbols, 7-6 
Unsigned integers, 3-2 
User macros, 3-3 
User Symbol Table, 7-6 
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